Porting NuttX to STM32F401RC-RS485 
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What you need to do the port? 


° Schematics: (why?) 
e Clock used: crystal freq., no crystal at all (internal oscillator), etc 
e External peripherals connected to MCU 
° Serial pins ( U(S)ART TX/RX pins) 
° Programming pins (SWD / JTAG) 
° https://github.com/lucaszampar/NuttX_STM32F4_RS485_DevBoard/blob/ 
main/PDF/NuttX_STM32F4_RS485.pdf 
° Microcontroller datasheet 
e Datasheets of chips used in the board 


15/10/2023 


First Steps to Board Port (Requirements) 


e NuttxX source code 
e Kernel: 
e Apps: 


° GCC or CLANG Toolchain for you MCU (microcontroller) 
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Find a board with similar microcontroller 


° Clear the environment: 
° cd nuttx/ 
e make distclean 
e Use a similar board as starting point (with same MCU or similar) 
e cd boards/<arch of your board>/<chip family of your board>/ 
e j.e.: cd boards/arm/stm32/ 
e git grep MCU_OF_YOUR_BOARD 
e i.e.: git grep STM32F401 
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CmakeLists.txt configs include Kconfig scripts src 


Create or copy a board.h 


° Enter inside stm32f401rc-rs485/include and remove the files: 
e $Is 


e $rm* 


° Now copy the board.h from stm32f411e-disco because it uses the 
same 8MHZ clock as our STM32F401 board: 


° $ cp ../../stm32f411e-disco/include/board.h . 
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Fix your Microcontroller Flash/RAM Size 


e Enter inside stm32f401rc-rs485/scripts and fix the Flash/RAM: 
° $ cd ../scripts/ 
e Open Id.script to setup fix Flash and RAM size for STM32F401RC: 


MEMORY 

{ 
flash (rx) : ORIGIN = 0x08000000, LENGTH = 128K 
Sram (rwx) : ORIGIN = 0x20000000, LENGTH = 64K 
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Setup your scripts/Make.defs correctly 


° Open Make.defs (still in scripts/ directory) and confirm it will call 
Id.config for our microcontroller: 


ifeq ($(CONFIG_ARCH_CHIP_STM32F401RC),y) 
LDSCRIPT = ld.script 
endif 
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CMakeLists.txt stm32_adc.c stm32_autoleds.c stm32_buttons.c 
stm32_spi.c Make.defs stm32_ajoystick.c stm32_boot.c 
stm32_Icd_ssd1306.c stm32_userleds.c nucleo-f4xtre.h 
stm32_appinit.c stm32_bringup.c stm32_mcp2515.c 


CMakeLists.txt stm32_appinit.c stm32_boot.c stm32f401rc-rs485.h 
Make.defs stm32_autoleds.c stm32_bringup.c 


Simplify stm32f401rc-rs485/src/CMakeLists.txt 


° Open CmakeList.txt and simplify it to: 

set(SRCS stm32_boot.c stm32_bringup.c) 

if (CONFIG_ARCH_LEDS ) 
List(APPEND SRCS stm32_autoleds.c) 

endif () 

if (CONFIG_BOARDCTL ) 
List(APPEND SRCS stm32_appinit.c) 

endif () 

target_sources(board PRIVATE ${SRCS}) 

if (CONFIG_ARCH_CHIP_STM32F401RC ) 
set_property(GLOBAL PROPERTY LD_SCRIPT "${NUTTX_BOARD_DIR}/scripts/ld.script") 


Simplify stm32f401rc-rs485/src/Make.defs 


° Open Make.defs and simplify it to: 
include $(TOPDIR)/Make.defs 
CSRCS = stm32_boot.c stm32_bringup.c 
ifeq ($(CONFIG_ARCH_LEDS),y) 
CSRCS += stm32_autoleds.c 
endif 
ifeq ($(CONFIG_BOARDCTL), y) 
CSRCS += stm32_appinit.c 
endif 
DEPPATH += --dep-path board 
VPATH += :board 
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Simplify stm32f401rc-rs485/src/stm32_appinit.c 


° Open stm32_appinit.c and simplify it to: 
int board_app_initialize(uintptr_t arg) 
{ 
#ifdef CONFIG_BOARD_LATE_INITIALIZE 
return OK; 
#else 


/* Perform board initialization here */ 


return stm32_bringup(); 
#endif 
} 
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Rename the LED name in stm32_autoleds.c 


e In stm32_autoleds.c just rename GPIO_LD2 to GPIO_LED1: 


void board_autoled_initialize(void) 


{ 
stm32_configgpio(GPIO_LED1); 


void board_autoled_on(int led) 
i 
if (led == 1) 
{ 
stm32_gpiowrite(GPIO_LED1, true); 


void board_autoled_off(int led) 
{ 


if i. == i 


Simplify stm32f401rc-rs485/src/stm32_boot.c 


° Open stm32_boot.c and simplify the init functions: 


void stm32_boardinitialize(void) 
{ 
/* Configure on-board LEDs if LED support has been selected. */ 
#ifdef CONFIG_ARCH_LEDS 
board_autoled_initialize(); 
#endif 
} 
#ifdef CONFIG_BOARD_LATE_INITIALIZE 
void board_late_initialize(void) 
{ 


/* Perform board init here instead of from the board_app_initialize(). */ 


stm32_bringup(); 


Simplify stm32f401rc-rs485/sre/stm32_bringup.c 


e Open stm32_bringup.c and simplify stm32_bringup() function: 
int stm32_bringup(void) 


{ 
int ret = OK; 


return ret; 


} 
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Simplify stm32f401rc-rs485/Kconfig 


# 

# For a description of the syntax of this configuration file, 

# see the file kconfig-language.txt in the NuttX tools repository. 
# 


if ARCH_BOARD_STM32F401RC_RS485 


endif # ARCH_BOARD_STM32F401RC_RS485 
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1) Add the entry to our board in boards/Kconfig 


° Return to the root of nuttx/ and edit boards/Kconfig to add first: 
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config ARCH_BOARD_STM32F401RC_RS485 

bool "STM32F401RC-RS485 Board" 

depends on ARCH_CHIP_STM32F401RC 

select ARCH_HAVE_LEDS 

select ARCH_HAVE_BUTTONS 

select ARCH_HAVE_IRQBUTTONS 

---help--- 
This is a minimal configuration that supports low-level test of the 
STM32F401RC-RS485 in the NuttX source tree. 


2) Add the entry to our board in boards/Kconfig 


° Add this second part to boards/Kconfig: 


default "stm32f401rc-rs485" if ARCH_BOARD_STM32F401RC_RS485 
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3) Add the entry to our board in boards/Kconfig 


° Add the third block to boards/Kconfig file: 
if ARCH_BOARD_STM32F401RC_RS485 
source "boards/arm/stm32/stm32f401rc-rs485/Kconfig" 
endif 
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CONFIG_ARCH_BOARD="stm32f401rc-rs485" 
CONFIG_ARCH_BOARD_STM32F401RC_RS485=y 
CONFIG_ARCH_CHIP_STM32F401RC=y 


Configure and compile your board: 


° Configure your board: 

e $ ./tools/configure.sh stm32f401rc-rs485:nsh 
e Compile it: 

e make -j 


LD: nuttx 
CP: nuttx.bin 
° Check file size: 
e $ls -| nuttx.bin 
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That’s all folks! 
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